Skip to content

fix(docker): trim the Docker Hub overview to before Bare metal, not by byte count - #4

Merged
DManavi merged 1 commit into
mainfrom
docs/dockerhub-overview-trim
Aug 19, 2026
Merged

fix(docker): trim the Docker Hub overview to before Bare metal, not by byte count#4
DManavi merged 1 commit into
mainfrom
docs/dockerhub-overview-trim

Conversation

@DManavi

@DManavi DManavi commented Aug 19, 2026

Copy link
Copy Markdown
Owner

What this does

Replaces the byte-count truncation for the Docker Hub Overview with a structural cut: everything from the top of README.md through the Docker Quick Start, stopping right before ### Bare metal. That's what a Docker Hub visitor actually wants — bare metal, Apache, shared hosting, and the full configuration/HTTP API/CLI reference are either irrelevant to someone looking at a container image, or better read in full on GitHub anyway. A closing line links to the complete README for the rest.

The cut lands at ~6,890 bytes — about a quarter of Docker Hub's 25,000-byte full_description limit — so there's no truncation-within-the-cut needed anymore (no more risk of stopping mid-code-block or mid-table). Kept a last-resort hard truncation in case that section ever grows past the limit on its own, so a future README change fails safely instead of the whole API request being rejected.

No separate trimmed file exists anywhere in the repo — this is produced fresh from the one README.md each time the workflow runs, per the earlier request not to commit a trimmed copy.

Verified for real

Dispatched against the current release and confirmed live: hub.docker.com/r/dmanavi/ddns's Overview is now exactly 6,890 bytes, starting with the README's title/badges and ending with the Docker section's last tip, a ---, and the link to the full README. Byte-for-byte matches a local dry run done before touching CI.

Merging this

Contains a fix commit, so merging will trigger a new release per the repo's automation.

…y byte count

Replaced the previous byte-budget truncation (which cut wherever 25,000
bytes happened to land - mid-code-block, mid-table, anywhere) with a
structural cut: everything from the top through the Docker Quick Start,
stopping right before "### Bare metal". That's the section a Docker Hub
visitor actually wants - bare metal, Apache, shared hosting and the full
reference are either irrelevant to someone looking at a container image or
better read in full on GitHub anyway.

The cut sits at roughly 6,900 bytes, about a quarter of the 25,000-byte
limit, so no truncation-within-the-cut is needed - a closing link to the
full README covers everything after. Kept a last-resort hard truncation in
case that section ever grows past the limit on its own, so a future README
change fails safely instead of getting the whole request rejected.

No separate trimmed file is committed anywhere - this is produced fresh
from the one README.md each time the workflow runs.
@DManavi
DManavi merged commit 66762d1 into main Aug 19, 2026
14 of 15 checks passed
@DManavi
DManavi deleted the docs/dockerhub-overview-trim branch August 19, 2026 17:12
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant